The enable-source-map Element

From Documentation


DocumentationZK Configuration Referencezk.xmlThe client-config ElementThe enable-source-map Element
The enable-source-map Element



Syntax: 

<enable-source-map>true|false</enable-source-map>

[Default: false]

It specifies whether to produce source map links for browsers to load the JavaScript/TypeScript source. By default, ZK only loads *.wpd, the merged JavaScript files of the same package. One wpd file contains multiple JavaScript files. Those files are merged upon JavaScript widget packages (e.g. zk.wpd or zkbind.wpd).

DisabledSourceMap.png

When enabling it, you can open the browser developer tool to check loaded source files and help you debug. You will see //# sourceMappingURL=/link-to-source-map.map in a wpd file.

ZK 8 and 9

A browser loads and shows each JavaScript widget file under src:

Zk9SourceMap.png

(A known issue that the line number in a source file might not always match the actual running code)

ZK 10

A browser loads and shows each TypeScript widget file under zk-build-utils:

Zk10SourceMap.png

Each loaded wpd file is split into multiple files e.g. zul1.wpd, zul1.wpd, zul3.wpd.



Last Update : 2024/06/26

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.


Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Configuration_Reference/zk.xml/The_client-config_Element/The_enable-source-map_Element&oldid=57283"